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_ The matertlal [neluded In this furctfona| 
spec{ficatfon, Inctuding but niet Limp ted 
to, jnstruction times ana oneratjin; 
Speeis |s for Infornatfion ourorses only 
A}| suco material 1s suoject %a chanaa 
without netice, Concaquently JEC make 
mo claim ana sna{| not oa [laogie for jts 
Accuracy, eS 


Unfess specified otherwise, tna terns 
wRsSKX" and WRSOSKeL Le I*ply "ROY eL Lan, 


INTROQUCTION 


 Peywweeenwnan ee 
= Pies $5 - 


The KSX=122 1/9 structure Is [mtended to provice a flexicie 


devicee ana functlone {naependent 140 capability taat can 
Suopert stendaro SbPeti cerleherals as weft as  snscial 
Dpurpese uevicas, rt ls exnrecten that ysers wil] aevaioer 


tnelr own tpacial nuraose device nandi|ina software. ans the 
PSX [/0 Structure has Neen designed to maka Jimlerantatian 
of 1/0 service aS clean and Strafght-forvwara as nossiciea 
(without faehntaieind = nystem [Integrity or afficency)4 


Perloneral device support fs Nes an [ntogral part of who ASK 
executive, It Ts provided by “orlvtieged Tares" calles [sc 

Handler Tasks, which may ba deveicned oF mad|ftied withaut an 
Intimate «xnowjege of the executive code, 


1/0 requests are jade to jog{]cal 1/9 un]ts, and ars ™acned 
Into onysical devicesunit references via a set af "avicg 
assjgnments", Each TasK« yas [ts own set of assignments, and 
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. 


they may pe changed althor by the. TasK |n. execution, or tron 
the coerator’s console TTY) 4 


An I/D request |s made py Instructing the system (vila Systen . 
.Ojrect{ve) to queue an [/0 request for an jnd|[cated LUN 
(Lagtoal unit Numoer), FIf the LUN Is ass|[ "ned to a physical 
unITts, and If the Handlaf Task to supoort that unlt is "emary 
residant and [nitlallzep, the request Is queved by onrtority 
Cusua|ly the reqyestini TasK's priority) in a Feqguest Tist 
for tne [nd[cated physical unit. 3 


not attempt to [nteroret thr the 
fFaquest, It anty pasisas [t to an 1/0 dandler Tas« per LUN 
--asslanment, and tne dispositfor of the request Is a function 
of tye Handjer Task (not tre id ae 


The RSX exacutive does 


Whan an-1/O0 paquast Tis aueued . “for a Task, control jis 
rFatuened [mmedlately (contingent upon Tasx oarlority, nf 
Goyrse) to the peguestiina Task, and tnat Task always nas the 
Option of suspend{|ng} execution yuntl!. completion of an [7/0 
~Pequest, of operpat{[ng asynchronously, 


Incleated Th any of three ootianal 
Filaq ay be specitflad to ba sat 
ration of a Slanifjeant event) at 1/0 
cutlon may be suspended (usi[nra the 
‘Lo an Indleatad Event Fings cr Jogteal 
Flags» [s set,f13  ¢2) An 1/0 status 
tn De sat At eotpletinn nf an 
operation, This word may oe cleared before sueuelng a 
-Feauest, ang then enecked parlosically, (3) a Systen Trap 
Service preutine nay joe |ncuvoeg [rn a- Task whricn wlil 
Interrupt tne Task’s execution uson 1/5 completion, 


1/9 cotplatf[on may de 
forms, (1). An Even 
(acconran|ed py a deci 
- completian, Task ex: 
-WAITTFO®S Ojrectiva) unt 
~Comofnasfon of Event 
Word may ae spec(ffa 


DEVICE [NOEPEND ENCE 


Paew~ewatenwseewnwws. 


179 requests ara nade to LOGITAL unTts, wifen are 
equivalenced to PHYSICAL devicewunits via a "Logical 'nit 
Table" (Lut), Logleal Units are represented oy Letical tintt 
Mumoers (LUNS), and eacr LUN IS reoresanten oy an mntrv In a 
"LCogTcal Unlft Tablte" (LUT, Physical aavicesun|ts are 
Fenresentad oy entelas Im a tabje caljed the Poysical tintit 
Directory (PUD), 


. a « . . 
ve_qesarawavevun 


C1] Tne WalTFOR Olrectiva srovides an “ORM comalnat{[on. and 
a serles of WAITFORS provides an AND", 
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Tne loaleal/onysical enulvajences are made by “ASSIGNIng 
LUNS to pnvsica] davicerunits, 


When a LUN Ts assigned to ai pnysf[eal devicewunit, the 
corasponi{[ng LUT entry (s{ot) [Ts sot to the address of tha 
corresronding PUD entry, 


When a LUN, Is deassigned assigned te NONE), the 
corresnonging LUT sjot IS zeroed, 


Eaen Tas: has Tts own Logical Unf{t Taole wr]en [s a parc of 
tna Task’s disk [maga that Js brouaht tnto memory wrhanaver a 
Task |S FIXED of whenever a noreFI XEN Task JS run, However, 
a Task‘s LUT Is not with[n Tts virtual aatdress Space, nan 
an 1/0 request [Ss queuad (vja tna QUEUE I/O Glractive) thre 
Fequesting tasx!s LUT ¢[n memory) Is uSed to aetaruine which 
phys}ox| deyiceeun| t js to perforn the request, and contents 
of any other LUT Is Trrevelant, 


There are four mechanisms fn RSX-110 [n wale tha sajectton 
Of a PHYSICAL 179 daviceeun|t can be alterea, They ara as 
follows, 


INSTALL == “nan a Task JS INSTALLed (MC? or Satcn) 
Into a svsten, tne nymber of LYUNS any tna 
assignment of each may be speclilea, Assianmants 
to deviceeuni[ts without resfaent Hanaler Ta3s$ ARF 
NOT flaggea, 


REASSIGN s= This “CR Function allows a Taskfs aisk 
pesTdsnt assfannents to be scnanted, <Assiaqnrents 
to devi[ce= mons witnoyt pasf{dent tanaloer Tas«s ARF 
flagged, 


ASSIGN «= This Dlrective allows a Task tno charge 
ts venory fesfdent GUN assignments, Assiqr-ents 
to devi[cerunits without res|qent Hanaler TasKs ARE 


f laggea, 

REDIRECT == This MCR Function alfows ALL requests 
of an {nafcatad PHYSICAL ceviceeunit to be 
redipactas to anotnar PHYSICAL cevice-unit, This 


Functlon 1s Intended to serve {im case of 
parlpseral faliures, ang soas rot Mrovid? nortaisy 
usafyl devica |ndesendence becaysea tinea redirection 
IS Indepencent of Tasw of QuN, 


A Task’s LIN assignments may 28 made soth before and “uring 
execution, Pres~avecution asslannents say be vase fron the 
MCR (or Satoh) tarsinal, ang runet[ae assfannents mv he 
made from tna executing Task, However, excert for the 
REQTRECT MOR Fyunetlon, there {is no means cf extarnally 
changing the 1/0 deviscerunits used oy a Tas«K unaer 
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‘execution, 


1/0 REQUESTS 


eup@aeevaww ea 
~ ae mrt 


1/9 requasts are ttade dy Tasks us[ng elther the “QUEUE [70 
PER TASK ASSIGNMENT GIRECTIVE", or tre "GUetC 170 PER MCE 
ASSIGNMENT OLRECTIVE", These dflrectives are |daatica! 
exceot for tha LUN asSsidnments used to an thea logical unit 
Into a phys[cal unft, Tre former uses the Taskfs own Lut, 
and tite latter (used ta cammunicate witn tna console 
Operator) uses the MCR Disnatch Task/s LUT, : 


Wnen a QUcVE 1/0 Dlrastive js Issued, a eneck !s mage to 596 
Tf the I/0 prenuest can 6a queuedi2), If |t cannot, che 
Olreectiva Status dord (fequestcer’s virtual zero) IS set 
Negative to I{ndleata rejection, and the negative vaiue 
Indicates thea caysa for relectior, If the OVRUE Gs 
Nlrect]va Is accented, a request node !s fortet anid Intzeries 
Into tne the deyicesyunit!s request queue, tne tiandler Ta4sx, 
Tf die, |{s tringersd Into services, ard tne recuester’s 
Ojrectiye Status word jis set posltilve (+1) ta Indicate 
peformance of tne <OITRECTIVE, An Event Flag and an 1/95 
Status pblock may pe soecifled to be set uprsan convletion 
(aTspos[tian) of the 1/0 raquast, 


Tnere [s a Separate 1/0 request queue for esacn onvstical. 
devi[cesun{t, Trese queues are aeques w~[tn thelr [Il stneacs 
In the PD antry for the corresdonding anysical devicaeunit, 
TO requests ara caureued oy orlfor{[ty w[th tne sralagneast 
‘prlorpity request at tne front of the aeaue, Rerauests cf 
equal prjorltv are Insertead Tn tne order In wnica the 
Faquests afe made, ; 


Tne QUEUE I/9 Directives are I[ndleaten by ~ Directive 
Ident|ficat{[on Codas (31Cs) “71" (for quete ner Tas<’s 
assignzents) ang "45" (for queue cer ACK assignrionts), with 
a Glrective Parameter Aiock (DPB) of tre following forrats 


Swe werwcasewan 


C2} Tnere are several reisons why an [1/0 request carnst se 
Queued! (1) tne Indlcated LUN does not exist, (2) tne Luu ts 
not assigqn#ég ts a physical unftt, (33 a Hantier Tasx to 
Service tne onysical ‘tevice {5 not peslarnt, (4) the 
cond}tions for quauf[ng soec{filed ware "ot net, or (5) a node 
for tne reguest aueue |S not avaljaole, 
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Wd, OF =~ OIC (31 of 43) 8 CEFN], 
“Wd, Jt e= 1/9 Funetion code, 

W4, 22 w= LUN & Caoueutna conditions], 
Wd, 63 == CPrjorjty] & Unused Bytes, 
Wd, 94 == [Adagress of {/0 Status Flock], 
Wd, 25 == Parameter #1, 

WO, J& == Parameter #2, 

Wd, 87 =- Paranatar #3, 

WO, 19 == Paramater #4, 

Wd, 11 <= Parameter #5, 

Wd, le e= Parameter #5, 

Wo, 13 «© Parameter #7, 


The GUEUE 170 Olrectives area deserloea In tne RSX=119 
WQIRECTIVES SPEC", 


I/O FUNCTION CODES 


Tew Cee ee ee 


WATle tne exacutive does net Intereret Function Codas, ft 
doas recoanize tne low order theee d]ts of ALL Ivo Fucntian 
Codes as the following "Function atricutes's 


Bilteo ©= No Return function, 
Blt-1 = rpaserved, 
Bitz =~ reservad, 


“A-"No Peturn”™ function Is one In whicn no status or data Ts 
returned 49 tne resuastor, In these cises, 32 TaSk may dueve 
Fenquests ang EXIT hefore thelr completicgn without Invoking 
(1/0 Rungowr, 


The folfowing [s a {7st of [/5 Functlonm Codes racoinizea *»y 
cormon riandjer fasks, It Is not a commijatea 1st af Function 
Codes (Any Handler Task may recoani[ze any function sare 
desired vy Tts Imnleananter) but rather a list cf codes used 
where daviced Indanendense |s feas{[bje and practicoa, 


BlO4,i2 ARITE LOGICAL RECGRO (LINE) 
BYG4AGL PRINT FILE 

O71739 READ LOGICAL PECCRO (LIME) 
OT16¢4 READ ULTaDUT ECHS (TTY) 
P1487 ATTACH UNIT TO TASK 

2*273 DECTACH UNIT FROM TASK 
292409 ALLOCATE SISK STORAGE 
OWIS7™E7 PBEALLOCATE OYSK STORAGE 
BlS4G% TRANSFER IN 

273431 LOAD TASK [MASE oe 

-@A4439 TRANSFER SUT 

B24% 1 RECORD TASK IMAGE @p 
B644y% OPEN FILE FOR INPUT 

2E5CHVS OPEN FILE FOR OUTPUT 
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“9@549% CLOSE FILE 
B2679% DELETE FILE 
B764¢2 RENAME FILE 


‘#® Executive functions perforrted cy disk ariver(s) 
onty for executive, 


1/0 STATUS BLOCK 


: 9 . 
Tew etaerweegnwaw Kt uweua 
*, ~ : fgbere - 


“When 170 comoletion status js des{red, the address of an [70 
Status Flock Ts Included In the Queve [70 DPs, Th]s Status 
“Block consists of two worys of the following format 


“Wd, 23 e= Status Value & Unused Byte, 
Wd, BL 2% Lanaoth of transfer Cin bytes) for 
* READ/WRITE functions, ang devices 
depandent [n aj! other cases, 


Tne feollow!ng [s a |[St of common|y returned J/0 status 
values, Al| passibfa Status values returned for a 
Particular aevice, are d3serload In the SX Spec for tka 
Handlor Task that seryi[cas |t, 


A positiv2 vajua Tmn{fles successful canojetion, and a 
Negat|ve valua |npiles rejection of fallur?, Tha oositive 
value returned |S WStyally ena (+1), however otner ocsitiva 
“Values mav be used, vizZer TTY Hanalare Tasx {dentifles oy 2 


‘AM termminat{[on on Inout, and *U & #*S tapaination on outayr, 


099 UNRECOGNIZE9 FUNCTION 
=12 IMVALIGO anSvess 

«29 INVAL{LO PARANFETERCS) 
a3Q UNIT ALREADY ATTACHED 


QUEUING MECHANISM 


Taq eZ antewe Deweoewawwe 
~ ae tote : 


whan an I/7 request TS quayed for a LUN, a request ais Is 
formeq ani Insertad sv orlority [n tne reauast I]3t for the 
Gevicewunjt to whlien tne LIN Is assjqneag, Tne fornat of the 
Fequest node Is as follovst 


Ad, 39 = Forward |Tnkaqer 

Wd, 24 28 Backward |[nkag*, 

Wd, 02 =e STO adaress (Task 13), 

Wd, 03 e= ATL noge ade of raqyestor, 
Wd, 24 == Priority 8&8 Unyusea 8yta 

dd, 05 2° LUN @ EFN, | 

Wd, 26 <¢ [70 Functlan “ode, 

Wd, 07 =" J/0 Status Qjocn address, 
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Wd, 28 4= Parameter #1, 
Wd, ii -= Parameter #2, 
Wd, 12 -° PoOrameter HS, 
Wd, 43 o* Parameter #4, 
Wd, 44 == Parameter #5. 
wa, 15 <* Parametor #6, 
vid’) 16 om Parameter #7, 


After a request node In Inserted [na devicesun([tfs recuest 
Tist, the four foflow|ns Operations causes of af[da the 
processing of tha !/M peaquestt (1) the Handler Task!s Event 
Flag one {[s set, (2) an "I/U Reaguests vueuad Counter” (for 
tne unit) fs Ineremanted, (3) an "17d Reayast3s Pandinag 
Count" (for the requestine Task) {s jryorementsads€3] and 44). 
a Sfaniflcant Evant Ts oeclares, | ae 


Whan an 1/2 Handier Task js Idjee Jt Issues A WAITROR 
 Ofrdetive w[tn Event Flaa one speciffed as an Cusuallys the) 
Evant Flag whose satting should cause Pesutpotion of Handler 
Task execution, Thus, an {dle Hancjes Task Js triagered 
Into service by the aveing of an 170 request for any of the 
units [t services, 


“ The 1/9 Rerteusts Queuved Counter Ts a werd Jn the PUN entry 
ef the un[t for, wafch tha retuest was cueues, Tris count Is 


- Tneremente4 for every request that js TWeUusd for the. unit, 


and tS orovided for Hantier Task usage, “ost Handjar y1s*s 
do not use {t, dut Some srecia} puronsa anc “ultleualt 
Handler Tasks ran onerate more affleartiy witr tate 
facii{ty, The count may os ajtered by toe Handjar Tas at 
any time, : 


The "2/0 nequasts Pending “aunt” is a word [In the ATL nore 


of eyery active Tas, This  ceunt Is Inecrenentat anc 
deerananted ta provide an Indication of pending 1/0 
requests, This fs uyses to delay the fraojng of Task’s . 


memory [f It EXITs of |S aborted with unsat([sfiled [/0 
Fequasts, 


Queutad an 1/40 request {s 2 Sisniflcant Evant because It Ts 
a poss[hje cause for Task switentng (rasynation af wander 
Task when It Is of a Aigner arforfty tAIA | tHe requestor 
Task), Tharefore, aA Sisnrjficant event Qeolaratjan [8S sare 
whenever an !/0 recuast 1s queued, 


5 E : 
Saneverweunaane 


C3) tf a "No Raturn” function, Requests PandiIng count Is iidT 
Tnorenantes, 
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HANDLER TASKS 


Seuwsenaneean 
peaaine 4 rs 


Under RSX=119, 1/3 |s supported hy "privi[jeged Tasks" cal'jec 
1/9 Hand|sp TaseKs,€4)] These Tasks are callec erivileyed 
besausa they nave access to (1) tne PPMPej}4 Exterral Page, 
(2) tno executilvefs Ilsts and tabjes, and ¢3) poutlnes whase 
Mi[suse coujd |ntarfere with normal systen spepattion, 
Privijaged Tasks are trusteq not to hog eaehey tne system under 
wWntch thay run, : 


‘Ts Handlar Tasks: consists of two epetonea (1) A "Task 
Tevel", ard (2) an “Interrupt service routine", Tna Task 
Teve| portion of an Y/C Hangler Task FuNnS AS a normal Task, 
with jts own context, and In a. Software orelerty 
multiproaramaing anvironnent, Tnh[s part of a wandjer Task 
generall|ly Intarfacas wlth tre executive (vlz, ‘denuveues 
Faquests) ani oerforms the oulk of tne I/0 services, The 
Interrupt service roytinea part of a Hand}er Task runs oper 
‘Wapdwars prierity ¢asyncironous to the. softwara orlority 
Multlprogramaing system) In resnonse to a perloharal aavice 
Thterfunt, ‘Interrupt service rout{nes run {nn ai nasition 
Independent enyironnant, and ganeraljy de as |ittle as 
poss]ole, ae 


Handler Task names are dictated by conventior so teat thelr 
Memory rasidency itay ba conventently contratlei, Tie nacre 
of an 1/0 Handler Task always consists of a two character 
-Symbo|[ lq oerf[aneral mata followea ov four gats (perlods), 
Y¥ize.» Thea dtandler Task tat susports OTL thru OTN Is callea 
MUO eae ie % 


Aly} Han|dar Tasks (at laast af|- that contatn [nterrunt 
Services routines) snould not ba ceclared "“cnecknolntarfe" 
When they are INSTALL2@qd [nto a systam, Ajso, 79St HANdlor 
Tasks vse their Inlt]Tallzation coda for Stack sterage coger, 
and therefora snmould cs declarea "Not Flxaole” wien 
UNSTALLEed, 


Handier Task resldency [Ss contro|/|eq py the followina “GR 
RUDE Hones 


LGA #9 This “CR Funetjon aliows an onerator ts 
cause [/0 Handlar Tasks to become ready to servyvica 
1/0 racquests, Hand|er Tasks ara. [ndicatad ov 
soec(|fylng symoalle parloheral Naves (viZae 
DT,'1.P.09), A pastition and/or prlorlty ay also 


Fauna waenaeaweg 
5 7 . 


[4] The.system disk driver |s a part of the executive 
assembly, Sut appears as an 1/0 Handler Task, 
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be specifled, If a Handjer Task cannot os loaded, 
(A pessction message |s output, - 


UNLOAD »~ This MCR Functien aljows an onerator to 
cAuse an I/0 Handler Tasx to case to service? 
requasts when Jts raquest aueuet(sS) are anpvty, 
This, of course, frees up menory, 


Whan a Handfer Task Ts joaded, [Tt Initlal{zes |tsa}f ara 
Instructs the system (WAITFOT ODlirectiye) to susnend Its 
exaoution until an 170 request js queted for tire Handjer 
Tas«, : 


% 


1/9 Handler Tasks afe suopi{mertedg by two Sets af “amory 
Fes[dent raeentrané subroutinos: (1) a Handjer Tas Il brarye 
and ¢2) tne System Syoroutines, : 


Tna Handler Litrary [s created Cor not createi) “at systen 
conflguratflon (SSEN), and providas routines that are easnan 
to the more sof{sticatea [40 services, vizse fille structure 
blocking/unblocking, access mMuthods,; atc, Tre kandjer 
Library ust 9a renantrant, but not nacassiariy 
pos|[tlon-[ndependent, 


Tha System Syuproutines are a part of the axacutive assenriys 
and ajwavs exist, These subFéltines orovide casic 
furcti[ons, most of whieh are cannon to all riandier Tasns 
Vizys Secuaue an 1/0 facuast nose, retiirn a node to tne 4 
of avallatie jist alemerts, ete, Tre use of Sy3 
“Subroutines by Handijer Tasks is sescr|[ "ed fater, 


’ 
eo] 
em 


Wnan a "porlvfliegad Task" {fs INSTALLed [nto a syste, the ASA 
contents for alj] but the Tasx cote ara tatermined ara 
cecorded with tAs Tasnxfés disk Image, Tne ennterts af the 
ASR used for Task code [3 cat ty the executiY¥se wean tae Tack 
Is joaded Coecayss tne real adtress sprce Jn -ewrh{on It fs 
loaded Is mot Fixed), The follow) yg |s a description af the 
vietual adaress space ajjocatfons (ASW usage) for J/5 
Handler Task level] cove, 


Virtual jocatfons 2299208917777 ¢CaSar) are used 

for Task lave] code, Note, thls code {s ljm|ted 
—6 $0 4K, 

Virtual jocations d230g9°977777 (ASPs 142.3) are 


used for exeacut{on cof Hangler Liorary routinas, 
Note, the Hanailjer Liorary |s [Jaited to led, 


Virtual locations 193¢0¢*157777 (ASRS 41,5,6) are 
used to accass tha axvetutiva’s tacles, fists, 191 
Syste™ Subroutines, ‘Note ee the systen |[sts, 
tables, poodle and System Sudroutines cannot 
excecde 12K, 
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“Virtual locatfons 269990+177777 (ASR7). ara used to 
access the PDPsii External Page, 


Wnlle Interrupt service routines are onysically a part of 
1/0 Handjer Tasks (usually a part of tne same asserDly), 
they are executed In Kernel mode, and under” the kerne|/s 
ASRS, Thus, |[ntarruct service rout|mes are written as 
pos|tilon-|ndepandent code (or written to Fun [In virtual 
address spaca S69090"077777)4 


The kerne| address space LPo20I91 77777 CASPS 4,5,6,7) ANd an 
1/0 Handler Tasnis (user space) ~ 19%e0cd"177777° are 


colncidentiy mapned, 1,8,, The executives tables, lists, 6 
Systam Suorout|nes, and the external paige ira avallanle to 
Interrupt service poutinas (kernal mode) as we{l as to a 


Handlerfs Tasx jeve| coca (ysor mode), 


SAMPLE HANOLER TAS 


i ee 


Tne following POPKii prosram Is a sample 1/70 Handjer Task to 
‘Support a single untt device called "LE" which orints 
_G[rectly fron a requastor’s memory, Tne purpose of this 


Sample orogran Js to Illustrate Handter Task construction, 
and does not represent ostimal coge of a functional Hanser 
Task, Al! coce unlaue to the dat[ce (not present|v aa 


exTstent parlpheral) nas oeen omitted, and In many cases 
registers are redundantly {goaded 4 3 : 


NOTE e= This sanole program |s [ncfurted for I} lustrati{an 


_Durposes oniy, It |S axbected trat coangag (oerr*anrs 
radjeal) [|| da made as angler Task Imp} lmentaition 
exoer|enca ITs gaalned, This samoi[e wil] be rea|aceqg Sv an 


actua| |Isting as soon as possldlja, 


Tne ofogras Ts used as an examole for tne renalnder of this 
Spes, , 


° * : . . : oe . 7 
eee ren ee re teenie aoa 
= ~ 3 8 ee . ” : 


} GENERAL REGISTER DEFINITIONS 
3 " 
RgsKke 
Rizat 
R2zke 
R3sKS 
Ryok4 
R52%5 
SpP=%6 
POSk7 — 
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a) 


MOV #OPBL,9(SP) 


GCS) Leto 


fn 


oI 


17 STATUS #O°D 


TS INTTIALTZS, 


SED FOR 


STACK 


1d 


FoR [NITEALIZATION 


} GLOBOL (EXEC) SYMGOL REFERENCES 
, 
46084 ry CUNT FCONSECT INTERRUPT 
»GLOBL eeOIMNT JOISCONNECT LsTTARUPT 
»GLOBL, »sOSUT JOECLARE & Ser. 
-),GLO8, ,,CLEF FPLEAR EVENT FL 
.GLOaL VeSTEF JSET EVENT FULAGES) Ltd 
GLOBL 1 NVI FIEeGUEYE AM 1/0 PEQUEST 
poe IBL peATUN JPATTACH UNIT 
GL 984 pp OT JOETACH UNIT 
- ,GLOBL ee lOQN pO NONE 
9 GLO8L veRNTP FRTN NODE TO POOL 
,GLOBL + sFLSH FFLUSH GUCUED 170 REQUESTS 
eGLOBL eyRNDN FRUN@CONN DONE 
~ , GLOBL »sINTX BINTERRUPT SERVICE EXIT 
~CGLOBL pypROTD GIO OF TASK BEING RYNCOWH 
1/0 REQUEST NONE ENTRY DEFINITIONS 
R,TG234 SYSTEM TASK MIRECTORY ENTRY 408 (REQUESTOR 19) 
R,RP2d6  fREQUEST PRIORITY © 24 
OR LUELS LOGICAL UNIT NUMRER 
RGF SAL ZEYENT FLAG NUMBER 
OR,FCsL2 51/0 FUNCTION CODE 
R,SAS14 j;A0NRESS CVIRTUAL) OF REQUESTOR 
R,PAsL& j;TEN@BYTE REGEUST PARAMETER BLOCK 
J QIRECSTIVE PARAMETER BLOCKS (DPSS) USE 
OpSiy 101, JSET@SYSTEMSTRAD KIC 
— 12 PWR RECOVESY TRaP 19 
PWRUP j;SERVICE ROUTINE ENTRY 
J} 
Opa2t | 121, PSETSSYSTENATPAP BIC 
41 P17O RUNDOWN TRaP 19 
TORUN sSSERVICE ROUTINE ENTRY 
8 
} VALRABLES YSED FOR INITIAL TZATIO® 
} 
@ IDEVICE 
20 } DEPENDENT 
2 i VARIABLES 
START © KANILER TASK ENTRY, HSANOLEH 
AND THE INUTLALI ZATION COOE 1S THEN 
STGRAGE, 
POWER@RETOVERY & T/O*RUNIOWN SYSTEM TRAP® ARE CONNECTCA TO 
THE SYSTEM VIA "SET SYSTEM TPAD" DIRECTIVES, 
TART] 


we meq we Be we Oe we wR we TO 
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‘EMT. 377° 
MOV.  #OPB2,°*¢S°) 
EMT $77 


AN INTERRUPT SERVICE ROUTINE IS CONNECTED To TRA? LOCATION 
240, AND THE BASF OF THE SERVICE ROUTINE’S pases SPACE 


‘IS SPECIFIED AS THE HANOLER TASKfS VIRTUAL ZERO 
IF THE SERVICE ROUTINE CANNOT BE CONWECTED (ANOTHER 


INTERRUPT SERVICE ROUTINE JS COMNECTED¢ THE HANOLER 


TASK EXITS, 


MOV. - #240,R3 | SYRAP ADR TQ RA 


MOV HUNTENT,RL FENTRY POL'NT TO RY 

CLR. R?2 }BASE OF ADR SPACE TO R2 
JSR. PCA CINT «CONNECT 
BYC EXIT JEXTT IF NOT CONNECTABLE 


‘THE HANDLER TASK IS DECLARED RESIDENT, AD ITS yenT 


TOENTUIFGSATION TABLE (UIT) AS IN IT TAGLE an 


IF NO UNITS FoR THE DEVICE EXIST s ‘THE HANDLER TASK 
DISCONNECTS & EXITS, | . 


MOV AULT RD © Tani 1D T8L AMR TO 22 


MOV. #4284 PNUMBER OF UNITS TO Ry 
' MOV #"LPYR2 JOEVICE NAME TO Re 


JSR Pp, ,OS''T s;OECLARE & SET 
ayc DAEXIT : , 


INITIALIZATION PECULIAR TQ THE PERIPHERIAL DEVICE 
SEING SyiPPORTED IS NOT SHOWN, 


Nop INEVICE 
NOP H DEPENQENT 
NOP } INITEALT ZATION 


INITIALIZATION COMPLETED es INSTRUCTIONS AO DATA 
PRECEOING TATS LOCATION ARE NO LONGER “EEDTO, THE 
HANDLER TASA*S STACK IS EXTENDED TO UTILITIZE 
THIS STG?AGE, 


MOV PC,S? . 
HANOLER TASK JS NOW TOLE ANDO REACY TO DewQveue REQUESTS 


THE HANOLES TASK/S EXECUTION 1s SUSPENTED UNTIL (0? 
UNLESS) LTS EVENT FLAG OME IS SET, 


THE TASK. WILL REMAIN SUSPENQED UNTIL AN 170 REQYEST 5 
QUEVED FIR ONE OF THE UNITS SERVICED ay THE HANDLER TASK 
(A UNIT TOENTIFIED IN THE UIT), 


1/0 OPERATIONS SE, 8 oo. oe ee RACE 4S 


a4 IF A SYSTEM TRAP OCCURS KHILE THE TASK IS WAITING FO? AN 
§ 1/0 REQUEST TO gE QUEUED, THE TRAP SERVICE ROUTINE wTLL 
—$ BE shan BUT THE TASK WELL REMAIN SUSPENDED, 


} 

IDLE? ; 

ore . | 

. MOV AUP Lye (SP) HALTFOR ear #4 

ae ENT 377 | 

i 

b TASK EXECUTION HAS RESUMED pEesuse ITS EVENT. FLAS ONE YAS 
} BEEN SE i 

; , Bix 
“} THE EVENT FLAG 18 CLEANED, AND AN ATTEMPT To SE UEUF’ 
“PA REQUEST FROM UNIT*2 (THERE IS CNLY ONE UNIT) IS “ATES 
; . 
OF TF A REGUEST IS MEwQUEYED, I7 1S PROCESSEL, IF A 

“YF REQUEST IS NOT OfeQUEUEO, THE cabal SECOMES IDLE, 
a | | 7 i 

hen . | ay 
- ' | an 

oe * MOV UIT+3,R9 = PUD ZMTRY AOR TO RB 

ges * MOV “ed Rd TFLAG IND TO Rt 

‘a ve S159 POaysCLEF ICLEAR EF #4 

; . 

of MOV" OUITHE, RI PUNT T=2 PUD ENTRY ADT TO a4 
an MOV BANA,R1 FRNA GUF ATR T? BL 
ae JSR PCy, DGRQ FORMOQUEUE ATTAMPT 
aA BvC IOLE JICLE IF NO CE@QUENE 

, 


FT CONTROL 1S OLSPATCHED To APPROPRIATE SERVICE Coaz PER 
1 U/0 FUNCTION COGE, 4ITH THE RE*YEST NONE ADDSESS GN RLY 


=_ we we we 


IF THE WEQUESTED FUNCTION COOE 1S NOT RECGGNIZED, AN 
1/O STATVS VALUE CF -99 1S RETURNED, 
“OV R FCC(RL),82 BSET I/O FUNCTION COOR IN R2 
; CMP Re,e sags AWRITE RPESUEST? 
3E0 AM TRES YES we WRITE LINE 
CMP HP, #416o0 INQ we ATTSCh PEPEUSTR 
BES ATTREN YES e~ ATTACH [TF PETATHES 
CMP RP,#20E% INO «= DETACH RENUEST? 
REO DETREA HYES e= DETACH TF ATTATHES 
CMP R2e#°L777743N0 we HAVILES EXTT REMESTI 
REQ EXTRED BYES | FINESH SEAVICE & EXIT 
“OV #99,,R9 JNO e~ YUNeMECOGNTZEZEND FUNeE TION 
JMP JNSUC 
WRITE PESUEST e= THE STARTING ADMRESS ANN LENGTH 
‘OF THE LINE TO GE WRETTo! ARE VALIDATE , UF Okay, 
THE LING TS PRINTED, IF NOT, Aly [70 STATUS VALUE 
OF #16 1S RETUNNEDS ; 


“ST we we we we we we 


RTREQ! NOP JVALTOATION YET To 
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NOP }BE DETERMINED 
I 
} EVENT FLAG TNO IS CLEARED, THE PRINT OPERATION IS 
} STARTED, AND EXECUTION IS SUSPEVDED UNTIL EVENT 
} FLAG THO 1S SET (SY INTERRUPT SERVICE ROUTINE); 
PFLE }REFERENCE POINT FOR PWR FAIL RECOVERY 
iy. = = 
MOV s«ULT#9,R2 so FGLEAR INTERRUPT FLAG. 
MOV #2,R4  «TFLAG IND TO Rt 
JS2.° PCy, ,CLEF {CLeaa EF #2 


if ee 
Nop JOEVICE 
NOP j DEPENDENT 
NOP H cone To 
“NOP i ; START 179 
; : ; 
MOY eMF2y=(SP) }WALTFOR ara #2 
EMT ($77 : - 
F28 SREFERENCE POINT FOR PWR FAIL RECOVERY 


REQUEST IS FINISHED SY SETTING THE REQUESTOR‘'S. 
Y/O STATUS WORD ¢IF SGGhELer ys ANDO EVENT FLAG 
(IF INOTCATED), 


ma we — = we TS we 


MOV - OFVSTS,R3 YFSUCCESSFUL COMPLETION? 
SPL suc FYES e~ RETURN STATUS = +4 
BR UNSUC {NO «- RETIR™ DEVICE status 


i 
1- ATTREQ” |= UNIT [S ATTACHED tT RESUESTING TASK (UNLESS 
$ ST-ITS ALREADY ATTACHES TO IT), 
; 
A 


TYREQ! MOV ULT+0,2r9 sUNITT<4 PUO ENTRY AOR TO Re 
JSR PCa ,ATUN fATTACH UNTT 


8VS SNC fIF SUCCESSFUL, SETUN STSs41, 


MOV Ae SARS SOTHERWISE, RETUPN STSae35, 
_ #R UNSUC 
j 


} DETREQ ©- UNIT IS DETACHED FROM REQUESTING TASK (UNLESS 


bUT TS HOT ATTACHED), 

H 

DETREQ! MQV UtT+d,R3 pUNLT=@ PUD ENTRY ADR To R17 
JSR PlayeOQTUN FCETACH UNIT 


AVS Suc JUF SUCCESSFUL, SETURN STS=+1, 
MOV #e3%,,R3  POTHERWISE, VETURW STSs"3a, 
BR UNSUC 


H 
: EXTREQ «= BONOUES TASK EXIT REQUEST w= CLEANUP §& EXIT 


EXTREG! Nop HDEVICE 
NOP j DEPENDENT 
NOP } CONE TO 


14 
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NOP 


' : ' 
} DECREMCNT REQUESTS PENDING COUNT AND RETURN 


we we we TE OH TE TE Ge 


} 


RNA AL 

R2 

#1,R3 
P0245 t09N 


RNA, AL 
PCa’, ,2NTP 


#240,R0 


51), °(SP) 


377 


Hoh, R3 


RMA, RY 
R2 
POGOe 1 TOON 


RMA,RL 
Por RNTP 


RNA 


ROFLAG 
hae 

Cae RNDN 
erat 


i 
: MOV 
CLR 
- MOV 
JSR 
MOV 
”. JSR 
; 
DAEXITE 
MOV 
“JSR 
ae 
EXITS 
3 
MOV 
EMT 
. - 
$ SUC v= FINISH SUCCESSFUL 
ie =. 
SUC} MOV 
UNSUCT. 
} : 
: MoV 
CLR 
‘JSR 
H 
MOV 
JER 
CLR 
; 
TST 
REO 
JSR 
‘SR 
H 
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TERMINATE USAGE 


{REQUEST NODE ADR TO Rt 
}NO SECRENENT ADJ 
PSTATYUS TO RS 

y1s0 DONE 


FREQUEST NMOF AOR TO R14 
RIN NODE TG POOL 


‘FOISCONNECT & EXIT 


{TRAP ADR TQ R™ | 
pOTSCONNEGT INTERRUPT 


pEXIT HANOLER TASK 
PEXTT CIRECTIVE 


REQUEST “ODE 


REGUEST, [70 STATUS IS SET TO +14 


FSET 170 STATUS IN 8S 


“ SREQUEST NODE ADR TO RL 
pNO CNTS PO ADY 
{t7o DN 


FREQUEST YNQE AOR TO Rt 
}RTY NOGE TO POOL 


IF AN T/O RUNDOS. SYSTEM TRAF GCCURRTO xHILE THE 
PRESENT REQUEST VAS NEMQUEUED, INDTOSTE 1/0 RUNe 
DGWN COMPLETE BY RESUMING THE RUNDOW! TASK, 


IT MUST BE REDONE, 


3}. : : : ; on 
-} UNSUC se FINISH UNSUCCESSFUL REGUEST, 23 CONTAINS STATUS, 


RNA! LS CLEAREO TO INDICATE "NG REQUEST DE-cyEYEeO" Ta 
THE T79 RUNDORN TRAP SERVICE RQUTI Nw 


} POWER RETOVERY SYSTEM TRAP w= IF A WRITE WAS STARTED 
} ANO NOT FINISHED, 
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; ; 
PWRUP{ > -CMP agp, #PF1  yrPr4? VLE, PC VLE, PF2t 2. 
a BLT PUREX [NO = EXIT SYS TRAP 

CMP OSP,#PF2 . } 
BGT Pw IREX fNO e- EXIT SYS TRAP 
MOV = - #PF1,8SP =f YES we CAUSE 170 TO BE RENONE 
MOV R4.<(SP) 
MOV Rie=(SP) 
MOV: ULT+2,29 
MOV #2—eR1L . 
JSR PC, ,STEF SET EF, #2. 
"OV | (SP)+,R1 
: MOV = (SP) +4,R2 
PHREX$ 


Moy aXST = (SP fEXIT SYSTEM TRAP ROUTINE 
EMT 377 


7 
2 170 RUNDOWN SYSTEM TRAP. 
Tonunt — Mov Ray seSP) 


MOV BUTT HS, 22 | 
(VSR PCy, .FLSH [FLUSH QUEvED REQUESTS 


“mq 


TST RNA 
BEQ INKR 
MOV fee Ra 
CMP ReTO(RGI 14 -ROLO 
BNE LAR? 
INC RNMFLAG 
BR IORX 
. 
TORR} JSR PCa, RNON 
5 
TORX! 
H 
MOV CSP)+,Ra4 
- MOV #XST, (SP) 
EMT 377 


; 
1 TASK DIRECTIVE PARAMETER BLOCKS 
3 


WFA3 1BYTE 41442 
20902 

3 : 

WF i iSYTE 44452 
£4292 

J 

XST3 103, 

' 


} TASK‘S VARTASLES 


(1/0 CPERATIONS PAGE 17 


J 


RNAI 4 SREQUEST NODE ADORESS 
ROFLAG; 3 $1/9 RUNDOWN FLAG 


; 
§ HANDLER TASK!‘S UNIT TENTIFICATION TASLE (ONLY CNE UNIT) 
UTTE a $OUD ENTRY ADR -FOR UNTT=2 


a i : 

J INTERRUPT SERVICE POUTINE =e POSITION INTEPENOENT ROUTUNE 
i CRUNS UNIER KERNEL ASAS, WHICH IS SET AT, JR AT SLOSELY © 
f RPELOW AS POSSTSLE, THE BASE OF THE INTERRUPT SERVICE 

-} ROUTINE’S ADDRESS SPACE AS SPECIFIED wWoen CONNECTED), 

f 
I 


NTENT3 = NOP DEVICE 
NOP H DEPENDENT 
“OP I INTERRUPT 
NOP } . . ° SERVICE COOE 


eae 
§ SET INTERRUPT FLAG 


MOV Ra,3(SP) 
HOV ULT+3,R@ 
MOMe- #2 YRL aj 
JSR Po. .STEF sSET EF, #2 
MOV . (SP)+,R2 7 


oe 
J EXITS INTERQUPT SERVICE ROUTINE 


ee JMP a (NTR, 
ye | te gai wet Ne, 
OEVSTS! 7 — FHAROWARE DEVICE STATUS 


J : 
e vENO = START 


e : - . . : . . . x . 
PRR OE SO wy Oy ST OE Oe nw OF we OD OS we OD DS we we De 
: = = ow * 


HAMNOLER TASK INITIALIZATION 


went erns2waentamrann eta *e Aw ererna 


Handler Task [njtJajTzatlon consf{sts of connacting to System 
Traps ana Rardware Interrupt(s)», datarminiag whiten 
davicaeun|ts exist (often oniy one) and Row gach Is 
Tdentiffed: and declaring the Handier Task rasiaent and able 
to de-quaua 1/9 paquests, 


17Q Handler Tasks normally use two Syste Tracs, Dover 
Feaovory, and I/O fyundawn, These Systan Trans provide a 
means of |nterrunting a Handilar Task*s morra!l ooaratinn 
whenever ower Is restored (after a oowar faflure)d, ana. 


1/0 OPERATIONS PAGE 18 


_Whenever a Task EXITS of TS aborted with 1/0 renues*s 

pendine, The System Trap service rout[nss are connected to 
_tne system (as are al| System Traas) us|ng tne SET SYSTEM 
' TRAP Directive, 2 


7 

Most Handler Tasks requi[re only one ‘Jnterrupt. servise 
-foytine, Mowever, as many as are desired tay exist wi[tniIn a 
Handier Task’, Connect]nga an [nterrupt service routine to a 
hardware |[ntarrunt Js [nrstructing the SysStan (14) to transfer 
control +9 an Indicated service routine wnenever an 
Interrupt occurs vfa an |ndicated [nterrunt tran adgaress, 
and (2) where the hase of the [nterrurt service routtinefs 
~padadress space [s ta be sat, — oe 4 od ee 


' A System Subrouv{ne to connect to an [nterrupt Is called as 
follows; 


RE e= Interrust trap address, 

Rl «2 Entry point of service routine, 

R2 #~ Base of |ntarrunt Serylece adarass snace, 

R$ e- BIts 2-3 preser}|be tne states of Toruition Todes 
Cy Ve 2, & N at entry to Interrupt service routine, | 


JSR PC,,,CINT 


When the connect js succassful, CCeV (Condition Code "V") Ts 
‘SET uoon suproutiIne return) If unsyccessful, CC#V Is CLEAR 
- Upon return, _ ey | 


In most cases, when an [nterfupt service routine cannot he 
connected, the Handj|er Task cannot runs and It sianiy EXtTs, | 
“However, t%e Handjer Task can be coded to do watever Is 

aporoprijats, 


In tne sample proqram, the I[nterrupt service routine 
teferenceas tne "Ntintt Identifleation Table" (UIT), but no 
other Dart of tne Tasx outsfds of tre tInterrunt service 
Foyutine, Hence, tha base of the [nturrunt service froutjre 
coy|d Nave bean sat as high as fUlT’, It Is set at the 
Task*s virtual zero to Snow that: "Unless a nanaler Task Is 
VYarser than 4K words, Interrupt service routine references 
do not restrict Handjer Task jayout", 


Wnen contro| |s transferrad to an [nterrupt Service routine, 
ASRS Js set as close ta tha specified “basa of Jnterrunt 
Servi[ce address space" withoyt excluding I]t, 1,@,, virtual 
Tocat[on 7627393 exfsts at a S2-eword pound at of bejow tha 
Jocatjon |nalcatad In R2, 


Aj{ Hiandjer Tasks provide space for a systomesat "init 
Idant[fi[catfon Table", This tabla consists of oneeword 
entrias for sach davicarun|t that tre HWanaler Task can 
Serv]ca, Words epresenting noneexistant untts (no PUD 
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entry) are set to zero, Words representing existing units 
are set to the coraspondins Pup entry adaressos, These 
addresses are normally used only as un[t  {dentiflers whan 
mak([ng requests of System SubroytInes} however, they also 
prov[de an access to a un}¢tés PUD entry, wnich js useful [fn 
some soec{a| cases, . 


A System Subroutine to initlall!ze thls table and declare the 
Handler 7ask resldent and ready to deequeye requests [s 
ajjed as followsi 


R@ z= Device name (two ASCII characters)» 
Ri e- Maximum nymber of units (tole size), 


JSR PCy, OSUT 


yf at least one PUN antry foz the specified device |{s founds 
CCe¥ fs SET upon subroutine return, If the device name is 
not found [nm the PUN, CC-v {Ss CLEAR uynon return, The 
Hanoler Task {s flagged residant jn tna PUD entry for aacn 
unTt |Jdentifled to the Hangler Task, : 7. 


IpLE STATE FOR HANMLER TASKS 


i te . . : . * 
Seen neewoat seeders owen 
ke * . % 25 - 


When a Handler Task Ts Idle, It suspends [ts execution untl | 
an 1/0 request is queued for a unlit Suoported by je, Tals 
Ts dona by {ssuing a wAITFOR Olrective, The Handler Task’s 
Event Flag one js set whenever a request [8, queued for ane 
of its un[ts, Normally the WALTFOR OMB Indicates Event Flag 
Range 1°16, and fjag number ane, however, In soma cases [tt 
may be desiraole (and |s possibla) to walt for mora than one 
Eyent Flag’s setting, . 


If a Power Recovery of a {1/0 Rundown System Trap oscurs — 
walle a handler Task |s Idle, the Task wi{! ramain sussanded 
ynjoss the System [ras - service routine cased {ts 
resumption, 


1/0 REQUEST PROCESSING 


Peewee meesereteesas 


When an Tdle Handler Tasks execution Is rasumed (as a 
fesujt of ts Event Flag one being set) {t normaliy clears 
that Flag before attemotins to deefueus ai raguest, (3) 
however, [n some speclal cases {t Is desirable to clear t9 
Queue Flag (Event Fiag one) at other times, 


Tne CLEAR EVENT FLAG Directive could-be ysed, howaver, Since 
the Privi[leged Task has access to the systanfs |[sts, a 
System Suoroutina [mposes less overhead {and can clear more 
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than. one flag), A Subroutine to clear. any Of a Handler 
Task‘s Event Flags 1216 |s called as fojjows} 


RO Se PUD entry address (from UIT), 
ORL se Flags [nd[cator, © 


JSR PCy, CLEF . 
“Ra. by ts G-15 represent Evont Flags 1-16 respect|lvely, 


“1/0 pequests for an Indicated unTt ave de-queued by usIng a 
-Subrout[ne to attempt to ce-queue a request node, This 
Subroutine |s called as foljows: a 


RO PUD Entry address (from UIT), 
RL e= Address of buffer for "RNA", 


JSR PCy, ,D0Ra 


Tf this subrout|[ne Ys called and the request j{st far 
Indicated unit [s empty, a request node Ts not daequeuad {of 
Course). Also, even when a request jist 1s not empty, it Is 
Possibila to NOT be able to de-queue a request because (1) 
‘She unit [S ATTACHead and no requests for the attaching Task 
are |n the |[st, and/or (2) requests }|m the ||st have been 

Made by a Task that Is checkpointed, 


‘When a request |s de-queued, the Request Node Address (RNA) 
Ts stored In the ouffer Indicated In Rt, a "Requests In 
Pracess Count" [s Inc¢remented,(6] and CC-V js SET wpan 
Subroutine return, When a request [s NOT desqueved, CC=v Is 
CLEAR upon subroutine return; 


When a pequest noda Js de-queued, [ts address Is set [n the 
Calling program(s buffer (nor RL) wltn Interrupts [nn{olted, 
ThTs |S done so that a nonezero RNA buffer can be used as a 
"paquest desqueyed" flag, ; ge 4 


° . - e . ' 
‘"BPeveeetveuneuweoe 
7 Sottey sO Se ae ears 


C5] To avold the race cond[tlon that exists whon a sosand 
Fequest |[s queyed Just after ai fallure to de=quaue has 
Saysed the Handijar Task to become Idle again; 


LJ x . t ¢ 
‘Peasteveenuvsaewwves 
oe o- “ae 


C6) {f "No Return" fynetfon, Reqyasts [n Progress Count Is 
NOT Incremented, | 
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The Requests {n Process Count [5s a byte In tne ATL node of 
eyery active Task, This count [s Incramentead whenever a 
Fequest for the Task {[s de=quaved, and decrenentad whenaver 
R request for the Task {Ts compfeted,€7] It provi[(des an 
Tndleatian of raauests belmg procassad, and ts used to delay 
the record|ng (Swapot[ng-out) of a cneckoointed Task unt] | 
¥/O0 In process nas been complated, : 


Nommajly after de-queulng a Feauost, the 1/0 Funct}lon Code 
Ys examined, and contro] |s transferred to a routine to 
Porform tne Indicated function, tf the function Is not 
Pecognized by tha Handler Task, @ Status of 99 (by 
convention) [Is retyrned, : 


Tf an ATTACH raquest |s de-equeued, and the unit Is not 
already attached (to the prequestina Task), the unlt Is 
flagged for the exciysive use of the attaching Task; This 
Cayses tne Dasqueue Request System Suoroutina ¢,,0QRQ) to 
only de=queve raquasts for that Task . 


A System Subroutine to attach a unit Is caljed as fol'jowss 


RB se PUD entry address (from UIT); 
RL se Request node address, 


VSR PC an VATUN 


‘When a un{t Ts attached; CCzV¥ [Ss SET upon subroutine return, 
When a unit [s NOT attached, CCey |s CLEAR upon return, 


If a DETACH request {8 de-ausued, and the unft Is attached 
¥o tne requesting Task, the ATTACH {s Mulllffed.. This 
Cayses tha Dewqueve Request System Subroyt[ne €,,00R9) to 
Geequeue fpom the tap (high orlority) of the unit's raquest 
Thsty | 

A system Subrout[na to detach from a uwnlt [s called as 
fo'| |ows} 


R@ =~ PUD entry address (from UIT, 
Ri 2= Request nade address, 


JSR PCy, OTUN 


Wnen a unit Ts getached, CCV Is SET ypom subroutine raturns 
When a un{[t [s NOT detached, CC+V [s CLEAR Uoonm roturn, 


. « . ry a 
Eewvrteeswsveweee 
~ aie moe sd 


C73 Uniess "No Raturn” funetion; 
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Many 170 requests sequire a transfer elther to orp from a 
Fequestor/sS memory, The’ ange of +heSe transfers muSt be 
‘yal{dated [n order to malntaln system Integer|ty, The 
foflowing three subroytines ald Tn thls operation, 


, 
A System Subroutine to valf[date a transfer and setup: an 
1&ebjt starting address (for a cerlpnerlal contrpol{jor) Is 
¢alled as follows] 


R2 29 First word addrpass ¢user virtual )a 
R3 == Transfer Jength (Tn bytes), 


VSR PCy 4 VXER 


“Vf the transfor Ts Invalid, CC=-V Ts CLEAR -upen = subrouttne 
Return, lf the transfer [s valld, CC=V ]8 SET upon return, 
and the 18=o]t stapti[na address [s Tn R4 & RS; The jow 
order 16 bits are In R5, and the high order two bits are In 
bIlts 5 4 4 of R4 WIth all otner R4 b{[ ts cleared, 


‘System Subroutines to validate a transfer, and |[f vaild 
Perform tha transfer, are called as follows} 


pas R2 =e F[rst word address. (user virtual). 
RS es Transfer Jangth (Tn words), 
R4 ee Memory buffer address 


“ QSR) PCy 4 yBLX! Fop transfer IN, 
; or 
“JSR. PC,,,8L40 For transfer OUT, 


T¢ the transfer 1S parformad, CCsy [s SET upon subdrouting 
raturn, If the transfer |S NOT performed, CC#V [Ss CLEAR 
Upon Ppaturn, 


When an {/0 operatyon |S complated, an Event Flag and an [1/0 
Status Word may be set (If Ind]cated |n rpanuest nodal, the 
Pequest[ng Taskis 1/0 Pending Coynt [S usually decremented, 
and [ts Reduests ‘In Progross Count |s decrementag, [3 


A System Subroutine to finish an 1/0 pequest [S called as 
follows} 


Ri == Request node address, 

R2 = Adjustment to unlty decrement, 
RS w= J[/0 Status Block Wd, G6, 

R4 es J/0 Status Block Wd, 344 


. e * e e 
Rewrteanveuneuvae 
* ame “ms wat 


£83 If "No Return" function, NEITHER. count [s alterod, 
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VSR PGy 24 fOON 


te an 170 Status B/ock address was spoc|ffed In the request 
node, the Status dock (In ths requestoris memory) |S set to 
the eontants of RS & R4, 


“t¢ an Event Flag nymeer was speact?}ed In the request Noda, 
that event flag 1s set and a Slanifieant Event Is declared, 


Tne 1/0 Retuests Panding Count for tha reauesting Task 1s 
decremented and then modifled by adding the contants of Re 
to |, R2 [s normally Zero, however In some cases the 
decrement(ng may be adjusted (viz, Ree+d for FILE OPEN and 
R2ee% for FILE CLOSE), The ATTACH 4% DETACH subroutines 
modify a Taskts 1/0 pending count so that a reauast [s 
eonsiderad panding walle a unit Ts attached to that Task; 


When an 1/0 request node Ia no jonger meedad by a Handier 
Task, [t'[9 returned ta the pool of avajtiabljé [Ist elements, 
A System Subroutina to return a mode ta the pool 13 called 
8g fol lowsi 


Ri ee Request node address, 
JSR PGay vRNTP 


When an [/Q operatfon Is started whose tarminatian Is_ 
Siqenajed ty a Aardware interrunt, the Handler Task may use 
tha WAETFOR INTERRUPT Directive te Suspend Its exacution 
unt{] the Interrupt or appropriate serlas af fraterrunts) 
has occurred, Nornatiy the Handler Taskis Event Flaq two 
(2) |s used as an “I[nterrust fiaa’, This flag 1s normaily 
efeared before starting an onaration amd set by an Intaréuot 
service routina ta sTanal completion, 


A Subroutine to clear any of a Handler Yaskis Eyent. FYags. 
1e{6 [s called as fojiewst 


R@ ee PUD entry addeoss (from UIT): 
Ri we Flags |ndjcator, 


. JSR PCy CLEP 
Ri bits Gei5 rapresant Event Flags 4916 raspoct}valy; 


A Subpout]ae to sat any of a Handior Taskts Eyent Flags {=16 
Ts cajled as fojlows} 


RO c= PUD entry address (from UIT), 
R4 29 Flags [nd{cator, 


JSR PCy,  STEF 
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Ri ae arte represent Event Flags 1ei6 respect} vely; 


HANDLER TASK EXIT 
‘Geessevesweesesss 


The UNLOAD MCR Funct]on [S used to cauSe aa Handler Yask to 
exTt, This Ts done by queying a jow prlor|ity request to the 
unlt reprasented by the davice/s first PUD entry, and 
Tnklbiting furthur aqueulmg by decjaring the Handiar Task 
Aoneres|[dent (in each PUD entry), The 1/0 function code for 

an ex]{t request [fs 177771 Coetal d,s ; 


In most sInnlerunit devices, sareienns an oxl*® peaquyest 
consTsts of finishing the request (,,J00N & 4,RNTP}, 
d}sconnecting from hardware Tnterrunts, and EXITIing, More 
complex Handier Tasks peaulre add[tlona| code to process al] 
‘ayeyed raquests before EXITing, 


WnT le a Handjer Task Is [In the process of eerie, }t cannot 
be peeloaded (tne LQAD MCR Funetlon wll} find 1% active), 


1/0 RUNDOW 


Eevswccocen 


‘When a Task EXITS or Is aborted w[th 1/0 reauestn pendina, 

the Task |s considseed active (ATL node and merory stfl| 

ex[st) but not runable, and a request to "rundown" fts [/0 

aca ¢yla SEND & REQUEST Directive) to a Task called 
oe O,," ) . ott ss . ; 


The 1/9 Rundown Tasks pequests Handjer Tasks to fiush auauad 
Peauests ‘and altner finish or abort any requests In orocess 
for an [ndl[cated Task, by ¢1) clear{ng |ts Event Flag onas 
(2) placing tne Task's STL node. address [In tha SCOM word 
“eRDIO, (3) causing an 1/0 Rundown System Trap for a 
Partloujar Handler Task, and (4) suspend|ng {ts execution 
until] Its Event Flag one Js set, 


When the Handler Task completes Tts 1/0 ryndown servicsa, It 
Pesumes the executfon of the I/0 rundown Task by setting [ts 
Event Flag one, 


A System Subroutine to set Event Flag one of a Task called 
72430,," [8 called as fo] lows} 


‘Tne 1/0 Rundown Task continues th]s process unt]] alther the 
Requests Pendina Count for the Task belng rundown Is 
doaremanted to zaro, or aj| devices have bean scanned (In 
whTch, case something Is wrong, ITkely a bad handjer)) 


1/0 OPERATIONS PAGE 25 — 


A System Subroutine to flush al{ pequests from ai device 
yequest {st for thea Task on which 1/0 i nelng pundown (per 
SgamM) Is ca|led as fajjows! 


R@ es PUD entry address (from ITN 
JSR PCyy i FLSH 


POWER» FAILURE RECOVERY 


When the systam recovers from a power fall[urey a Power 
Recovery System Trap |{s generated for aj{ Tasks that are 


. Setup to saryice the trac, 


1/40 ‘Handler Tasks are coded ‘to do what ever Is necessary to 
Pesover, . In some cases, thTs Is simply repeating a request 
Tf a paquest was being processed, viz,, Hagtane read, tn 
eather casos, recovery Is determined py the degres cf 
completion at power fallure, Viz If power falis during a 
Magtape write, the Handjo# Task must detarmine wheather 
anything was written and condi tional|y backspace bafore 
beewrltiag, 


